How to Migrate Capella Project

When upgrading to a new Capella product, your older models may not be compatible right away with this new version. In order to facilitate this transition, Capella offers a migration feature that allows you to migrate your models.

The migrated projects are not backwards compatible. This means that once they are migrated to the new version, they can not be opened with the previous Capella versions. For more details please refer to the Capella versions requiring a project migration section below.

We strongly recommend that you baseline your model in a version control system before performing the migration operation. Once this is done please continue with the following migration steps:

  1. Migrate any libraries towards wich you model has any dependencies. If your libraries have dependencies towards other libraries then they must be migrated first. You should start your migration process with the library that has no external dependencies, and continue progressively to the top dependency.
  2. Migrate your projects.

In order to launch the migration process of a Capella Project you must right click on the project and choose Migration > Migrate Project toward current version. The same steps apply to libraries as well.

The displayed dialog allows you to to make a versioned backup (baseline) of the model before running the migration. These backup files will allow you to recover your model in case of any migration problems, even if the model is not managed in a source control system.

We highly advise you to enable the option “Backup models before the migration”.

Some additional migration commands are available on semantic and diagram files allowing advanced migration processes by triggering a migration on each of these files kind separately. For more details see the Commands & User Profiles section.



At the end of the migration process, we recommend you to run a manual global refresh on all the diagrams of the migrated project. For more details see the Diagram Refreshing Strategies section.


Capella versions requiring a project migration

The following table presents the Capella version transitions that require a project migration.

Previous Capella Version Upgraded Capella Version
1.2.x 1.3.x
1.3.0 1.3.1

Project migration in command line

Please refer to the document at Migration command line for more details about launching project migration in command line. An example of how to migrate projects in batch mode can be found at Migration command line in batch mode.